home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 5 / Gold Medal Software - Volume 5 (Gold Medal) (1995).iso / archive / s_s30.arj / SS.DOC < prev    next >
Text File  |  1993-08-19  |  114KB  |  3,568 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                      ShapeShifter(tm)  Archive Conversion System
  30.  
  31.                         Copyright (c)1992-93 By Curtis Little
  32.  
  33.                                  All Rights Reserved
  34.  
  35.  
  36.  
  37.                        "Software Solutions That Make Sense"(tm)
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                   Table of Contents
  47.  
  48.  
  49.  
  50.  
  51.           License . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  52.  
  53.           Warranty  . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  54.  
  55.           Getting Started . . . . . . . . . . . . . . . . . . . . . . .   6
  56.                Acknowledgments  . . . . . . . . . . . . . . . . . . . .   6
  57.                How to Contact the Support Board . . . . . . . . . . . .   6
  58.                Required Equipment . . . . . . . . . . . . . . . . . . .   6
  59.  
  60.           Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   7
  61.                Overview of ShapeShifter . . . . . . . . . . . . . . . .   7
  62.                ShapeShifter Features  . . . . . . . . . . . . . . . . .   7
  63.                Registering ShapeShifter . . . . . . . . . . . . . . . .   9
  64.                Using a Mouse  . . . . . . . . . . . . . . . . . . . . .   9
  65.                     Selecting menu items with a mouse . . . . . . . . .   9
  66.                     Selecting an input field with a mouse . . . . . . .   9
  67.                     Exiting an input screen with a mouse  . . . . . .    10
  68.                     Using a mouse on dialog boxes . . . . . . . . . .    10
  69.                Starting ShapeShifter  . . . . . . . . . . . . . . . .    10
  70.                ShapeShifter Command Line Options  . . . . . . . . . .    11
  71.                Specifying On/Off Options  . . . . . . . . . . . . . .    12
  72.  
  73.           ShapeShifter Option Descriptions  . . . . . . . . . . . . .    13
  74.                Archiver Name  . . . . . . . . . . . . . . . . . . . .    13
  75.                Author Verification  . . . . . . . . . . . . . . . . .    14
  76.                Bad files directory  . . . . . . . . . . . . . . . . .    15
  77.                Check for Self Extr. . . . . . . . . . . . . . . . . .    15
  78.                Command to Execute After All Conversions Are Complete     16
  79.                Command to execute after creating an archive with this
  80.                     archiver  . . . . . . . . . . . . . . . . . . . .    17
  81.                Command to execute before beginning the conversion
  82.                     session . . . . . . . . . . . . . . . . . . . . .    17
  83.                Command to execute before creating an archive with this
  84.                     archiver  . . . . . . . . . . . . . . . . . . . .    18
  85.                Command to execute before extracting an archive with
  86.                     this
  87.                     archiver  . . . . . . . . . . . . . . . . . . . .    18
  88.                Convert archives containing subdirs  . . . . . . . . .    19
  89.                Convert to . . . . . . . . . . . . . . . . . . . . . .    19
  90.                Create Command . . . . . . . . . . . . . . . . . . . .    20
  91.                Create list of files converted . . . . . . . . . . . .    20
  92.                Date Stamping Method . . . . . . . . . . . . . . . . .    21
  93.                Dir File(s)  . . . . . . . . . . . . . . . . . . . . .    22
  94.                Dir Type . . . . . . . . . . . . . . . . . . . . . . .    22
  95.                Extension  . . . . . . . . . . . . . . . . . . . . . .    23
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                Extract Command  . . . . . . . . . . . . . . . . . . .    24
  104.                File Attributes  . . . . . . . . . . . . . . . . . . .    24
  105.                File Offset  . . . . . . . . . . . . . . . . . . . . .    25
  106.                File Start,Len . . . . . . . . . . . . . . . . . . . .    26
  107.                Keep original archive  . . . . . . . . . . . . . . . .    26
  108.                Keep original file if it's smaller . . . . . . . . . .    27
  109.                Log File . . . . . . . . . . . . . . . . . . . . . . .    27
  110.                Logging Level  . . . . . . . . . . . . . . . . . . . .    28
  111.                Max age of files to convert  . . . . . . . . . . . . .    29
  112.                Memory to make available . . . . . . . . . . . . . . .    29
  113.                Preserve Author Verified files . . . . . . . . . . . .    30
  114.                R. Just  . . . . . . . . . . . . . . . . . . . . . . .    30
  115.                Recurse Archives . . . . . . . . . . . . . . . . . . .    31
  116.                Recurse Subdirs  . . . . . . . . . . . . . . . . . . .    31
  117.                Redirect I/O . . . . . . . . . . . . . . . . . . . . .    32
  118.                Redo archives that are already the target type . . . .    33
  119.                Save Converted List in . . . . . . . . . . . . . . . .    33
  120.                Scan All Files . . . . . . . . . . . . . . . . . . . .    34
  121.                Scanner supports subdirs . . . . . . . . . . . . . . .    35
  122.                SFX Id String  . . . . . . . . . . . . . . . . . . . .    36
  123.                Size Start,Len . . . . . . . . . . . . . . . . . . . .    36
  124.                Strip attributes (HSR) . . . . . . . . . . . . . . . .    37
  125.                SubDirs  . . . . . . . . . . . . . . . . . . . . . . .    37
  126.                Switch! to EMS . . . . . . . . . . . . . . . . . . . .    38
  127.                Switch! to XMS . . . . . . . . . . . . . . . . . . . .    38
  128.                Test Only  . . . . . . . . . . . . . . . . . . . . . .    39
  129.                Update BBS/Dir File With New Extension and Size  . . .    39
  130.                Use 43/50 Line Mode  . . . . . . . . . . . . . . . . .    40
  131.                Use Switch!  . . . . . . . . . . . . . . . . . . . . .    40
  132.                Use Virus Scanner  . . . . . . . . . . . . . . . . . .    41
  133.  
  134.           Appendices  . . . . . . . . . . . . . . . . . . . . . . . .    42
  135.                Appendix A - How ShapeShifter Detects Corrupt
  136.                     Archives. . . . . . . . . . . . . . . . . . . . .    43
  137.                Appendix B - Archivers, Scanners, and User Programs
  138.                     Supported by
  139.                     ShapeShifter  . . . . . . . . . . . . . . . . . .    46
  140.                Appendix C - ShapeShifter Error Messages . . . . . . .    47
  141.                Appendix D - Specifying Command Lines  . . . . . . . .    54
  142.                     Example Command Lines . . . . . . . . . . . . . .    55
  143.                Appendix E - Answers to Commonly Asked Questions . . .    57
  144.  
  145.           Index . . . . . . . . . . . . . . . . . . . . . . . . . . .    58
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.           License
  155.  
  156.           You are granted a nonexclusive personal right to use this Software
  157.           under the terms stated in this Agreement.  Unregistered users are
  158.           allowed to evaluate this software for a period NOT TO EXCEED FIFTEEN
  159.           (15) DAYS.  If, on or before this time expires, you wish to continue
  160.           using this software, you must register by sending the registration fee
  161.           to the author "Curtis Little" for EACH COPY to be used.  A message may
  162.           be displayed to remind you if you exceed the trial use period.  
  163.  
  164.           You may not modify or alter the Software or any of the accompanying
  165.           files and/or documentation.  This license is effective until
  166.           terminated.  You may terminate it at any time by destroying your
  167.           copies of the Software.  It will also terminate if you fail to comply
  168.           with any term or condition of this Agreement.  You agree upon such
  169.           termination to destroy your copies of the Software.
  170.  
  171.           The shareware version of this software may be freely distributed as
  172.           long as the following conditions are met:
  173.  
  174.                1)   All files are distributed as is and in unmodified form.
  175.  
  176.                2)   No more than a $5.00 handling fee can be charged without the
  177.                     express written consent of the author "Curtis Little".
  178.  
  179.                3)   This Software may not be distributed with or as a part of
  180.                     any other product or software package without the express
  181.                     written consent of the author "Curtis Little".
  182.  
  183.           Registered users may not transfer or assign ownership of this license
  184.           to any other person without the express written consent of the author
  185.           (Curtis Little).  Attempts to sublicense, assign, or transfer any of
  186.           the rights, duties, or obligations hereunder is void.  You may not
  187.           copy, modify, alter, electronically transfer, or lease the registered
  188.           version of this Software and supporting files.  Registered owners may
  189.           use this software on more than one computer providing there is no
  190.           possibility it will be used on more than one computer at any one time.
  191.  
  192.           Business and government users of the Software are not allowed the
  193.           evaluation period.  Use in a business or government institution
  194.           without first paying the required registration fee is in violation of
  195.           this license agreement.
  196.  
  197.           By using the Software you acknowledge that you have read this
  198.           agreement, understand it and agree to be bound by it's terms and
  199.           conditions.
  200.  
  201.  
  202.  
  203.           4                                            ShapeShifter License
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.           Warranty
  213.  
  214.           With respect to the physical diskette sent to registered owners,
  215.           the author warrants the same to be free from defects in materials
  216.           and workmanship for a period of 60 days from the date of 
  217.           registration.  In the event of notification within the warranty
  218.           period of defects in material or workmanship the author will
  219.           replace the defective diskette.  The remedy for breach of this
  220.           warranty shall be limited to replacement and shall not encompass
  221.           any other damages, including but not limited to loss of profit,
  222.           and special, incidental, consequential, or other similar claims.
  223.  
  224.           The author specifically disclaims all other warranties, expressed
  225.           or implied, including but not limited to implied warranties of
  226.           merchantability and fitness for a particular purpose and the
  227.           program license granted herein in particular, and without
  228.           limiting operation of the program license with respect to any
  229.           particular application, use, or purpose.  IN NO EVENT SHALL THE
  230.           AUTHOR BE LIABLE FOR ANY LOSS OF PROFIT, LOST SAVINGS, COMMERCIAL
  231.           DAMAGE, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT
  232.           OF THE USE OR INABILITY TO USE THIS SOFTWARE EVEN IF THE AUTHOR
  233.           (Curtis Little) OR AN AUTHORIZED REPRESENTATIVE HAS BEEN ADVISED
  234.           OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER
  235.           PARTY.
  236.  
  237.           This agreement shall be governed by the laws of the state of
  238.           California.
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.           ShapeShifter - User's Guide                                     5
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.           Getting Started
  273.  
  274.  
  275.           Acknowledgments
  276.  
  277.           In this manual several products are referred to:
  278.  
  279.                MS-DOS is a registered trademark of Microsoft Corporation.
  280.  
  281.                PKZIP & PKUNZIP are registered trademarks of PKWare, Inc.
  282.  
  283.                ARC is a registered trademark of SEA
  284.  
  285.                IBM PC, XT, AT, and PS/2 are trademarks of International
  286.                Business Machines, Inc.
  287.  
  288.  
  289.           How to Contact the Support Board
  290.  
  291.           An electronic bulletin board is used to support ShapeShifter. 
  292.           You may contact the support board 24 hours a day.  The support
  293.           board is:
  294.  
  295.                Lost At C BBS
  296.                (303) 280-1007
  297.  
  298.           You may also contact me via US mail at:
  299.  
  300.                PO Box 33613
  301.                Northglen, CO  80233
  302.  
  303.           If you have any questions/suggestions regarding ShapeShifter feel
  304.           free to call or write.  The support board is open to the public,
  305.           however, registered users will receive priority service.
  306.  
  307.  
  308.           Required Equipment
  309.  
  310.                IBM PC, XT, AT, PS/2 or MS-DOS Compatible
  311.                MS-DOS 2.0 or above
  312.                At least 256K memory available to application programs
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.           6                                  ShapeShifter - Getting Started
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.            
  328.  
  329.  
  330.  
  331.           Introduction
  332.  
  333.           Overview of ShapeShifter
  334.  
  335.           ShapeShifter is a highly sophisticated program designed to make
  336.           the task of converting from one archive format to another an
  337.           effortless task.  ShapeShifter is also handy for scanning files
  338.           contained in archives for viral infections.  ShapeShifter sports
  339.           many options affording the user a great degree of flexibility
  340.           (ShapeShifter can even be set to automatically update BBS dir
  341.           files!).  Since ShapeShifter is designed to be used as a command
  342.           line utility, it can be used for unattended operation (unattended
  343.           operation is effectively available to registered users only due
  344.           to the opening delay screen).
  345.  
  346.           This manual is intended as more of a reference than a users
  347.           guide.  I don't expect that too many people are anxious to sit
  348.           down and read a long boring guide about a program when it's
  349.           relatively easy to make things work without doing so.  At a
  350.           minimum you may wish to read this section of the manual to learn
  351.           how to call ShapeShifter, and then refer to the reference section
  352.           of the manual when you desire to learn the specifics about a
  353.           certain field or error message.
  354.  
  355.           This section of the manual lists the major features supported by
  356.           ShapeShifter followed by brief instructions on the calling syntax
  357.           for ShapeShifter.  Later sections of the manual explain each of
  358.           ShapeShifter's options in detail.
  359.  
  360.  
  361.           ShapeShifter Features
  362.  
  363.           ShapeShifter's major features include the following:
  364.  
  365.                o    Supports internal recognition of self extracting files. 
  366.                     The user has the capability to specify how ShapeShifter
  367.                     should recognize self extractors as well (allowing
  368.                     future formats to be supported!)
  369.  
  370.                o    Mouse support
  371.  
  372.                o    Support for virtually all archive types both past and
  373.                     present.  The user may configure ShapeShifter to use
  374.                     future archive types in addition to adding support for
  375.                     types not configured at default.  (And I won't claim
  376.  
  377.           ShapeShifter - User's Guide                                     7
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.                     ShapeShifter is the only one to support this like some
  386.                     others do ;-)
  387.  
  388.                o    Supports a user configured Virus Scanner.  The user has
  389.                     the freedom to determine which virus scanner (if any)
  390.                     should be used.  Even if your scanner doesn't support
  391.                     subdirs, ShapeShifter can properly handle it so even
  392.                     archives that do have subdirectories will have every
  393.                     file scanned!
  394.  
  395.                o    ShapeShifter can not only log information about the
  396.                     files converted, but it can also automatically update
  397.                     the BBS directory file(s) for virtually all BBS types
  398.                     available today.
  399.  
  400.                o    Supports author verified files created by PKZIP.  Since
  401.                     many authors (like myself) use PKZIPs -AV feature to
  402.                     certify authentic files, ShapeShifter was designed to
  403.                     not modify these files unless you specifically tell it
  404.                     too.
  405.  
  406.                o    ShapeShifter can run virtually all archiving programs
  407.                     to perform the conversion - including memory hogs that
  408.                     can't be run from other archive converters. 
  409.                     (ShapeShifter uses Switch! technology to free memory
  410.                     for the archivers that need it).
  411.  
  412.                o    Output of the archiver programs can be redirected (and
  413.                     *yes* this does include LHA!).
  414.  
  415.                o    Nested archives are no problem for ShapeShifter. 
  416.                     ShapeShifter can efficiently convert nested archives to
  417.                     the desired format.
  418.  
  419.                o    Provides full support of subdirectories in the
  420.                     archives.  If the archiver you're using supports
  421.                     subdirs, ShapeShifter can as well!
  422.  
  423.                o    Provides full support for file attributes (read only,
  424.                     hidden, and system).  If the archiver you're using
  425.                     supports attributes, ShapeShifter can as well!  If you
  426.                     desire, ShapeShifter can automatically strip file
  427.                     attributes during the conversion.
  428.  
  429.                o    43/50 line mode for EGA/VGA adapters is supported.
  430.  
  431.                o    ShapeShifter can recurse subdirs looking for files to
  432.                     convert, allowing simple conversion of every file on
  433.                     your computer's disk(s)!
  434.  
  435.           8                                     ShapeShifter - Introduction
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.                o    ShapeShifter allows a great deal of customization. 
  444.                     There are numerous options to control operation as well
  445.                     as hooks you can use to call your own programs to do
  446.                     things such as save archive comments before conversion,
  447.                     and then reinsert them after conversion!
  448.  
  449.           It's funny to note the list above doesn't scratch the surface of
  450.           ShapeShifter's power.  ShapeShifter clearly sets new standards
  451.           for archive conversion software.
  452.  
  453.  
  454.           Registering ShapeShifter
  455.  
  456.           ShapeShifter is *NOT* free software.  It is distributed as
  457.           shareware to allow users to test it before purchasing it.  (It is
  458.           shareware instead of commercial simply because I prefer the
  459.           shareware concept over the inflated prices that go with
  460.           commercial software to cover overhead that the user doesn't care
  461.           about anyway).  If you like ShapeShifter please send the
  462.           registration fee of $15.00 to the author.  For a measly $15.00
  463.           you will help support this software and help insure new shareware
  464.           products will be available from the author.  
  465.  
  466.           Your $15.00 entitles you to use any version of ShapeShifter, and
  467.           includes a way to remove the beginning and ending delay screens
  468.           for all past and future versions of ShapeShifter.
  469.  
  470.           Using a Mouse
  471.  
  472.           ShapeShifter supports the use of a mouse.  If you have a mouse
  473.           driver enabled on your PC, ShapeShifter will automatically turn
  474.           on the cursor and be set for use of the mouse.  Note that due to
  475.           the nature of ShapeShifter, the main place a mouse can be used is
  476.           the configuration program (SSCFG).  The command line program SS
  477.           supports a mouse for the error message prompts only.
  478.  
  479.           Selecting menu items with a mouse
  480.           Using a mouse in ShapeShifter is pretty easily.  At menus simply
  481.           put the cursor on the item you wish to select and click any of
  482.           your mouse buttons.
  483.  
  484.           Selecting an input field with a mouse
  485.           On field input screens, you may use your mouse to select the
  486.           field to edit.  Simply put the cursor on the first character of
  487.           the input field you wish to modify, click, and the cursor will be
  488.           moved to that field ready for input.
  489.  
  490.  
  491.  
  492.  
  493.           ShapeShifter - User's Guide                                     9
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.           Exiting an input screen with a mouse
  503.           After you are finished editing fields on an input screen, you may
  504.           use the mouse to specify whether to save or abort changes. 
  505.           Simply click the mouse on the portion of the bottom status line
  506.           that contains the text describing what you want to do.
  507.  
  508.           Using a mouse on dialog boxes
  509.           ShapeShifter displays prompts and error messages using a dialog
  510.           box.  With a mouse, simply click on the box containing the answer
  511.           you want to give.
  512.  
  513.  
  514.           Starting ShapeShifter
  515.  
  516.           When you call ShapeShifter you specify what it should do using
  517.           parameters on the command line (default settings as well as a few
  518.           options that can't be specified on the command line are
  519.           configured using SSCFG.EXE).  With ShapeShifter you are not
  520.           restricted to using different types of parameters in a predefined
  521.           order; ShapeShifter can handle parameters in any order you
  522.           specify them.  The types of parameters that ShapeShifter accepts
  523.           are:
  524.  
  525.                o    On/Off Options
  526.  
  527.                o    Other Options
  528.  
  529.                o    File names
  530.  
  531.           Options configure the way ShapeShifter operates.  Any parameter
  532.           that starts with a '-' or '/' is considered to be an option. 
  533.           There are two categories of options that you should be aware of. 
  534.           The first type of option can only have an on or off value.  These
  535.           options are specified with the following format:
  536.  
  537.                /option[+-]
  538.  
  539.           Note that the trailing + or - sign is optional, and if present
  540.           specifies how the option should be set (+ = ON, - = OFF).  If you
  541.           don't specify a trailing sign the option defaults to ON.
  542.  
  543.           The second type of option is one that can have a value other than
  544.           on or off.  The format for this type of option is:
  545.  
  546.                /option=XXXXX
  547.  
  548.           Note that the equal sign followed by the value to set the option
  549.           is required.
  550.  
  551.           10                                    ShapeShifter - Introduction
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.           File names specify the file(s) that ShapeShifter should operate
  560.           on.  ShapeShifter allows you to specify as many filespecs as you
  561.           like - any of the specified file names can contain wildcards.
  562.  
  563.  
  564.           ShapeShifter Command Line Options
  565.  
  566.           There are quite a few options available that allow you to control
  567.           how ShapeShifter operates.  The following list shows the options
  568.           that can be used on the command line (see the option reference
  569.           for details on what each option does):
  570.  
  571.            /4       Sets the 43/50 line mode option.  (On/Off Option).
  572.  
  573.            /A=XXX   Sets the maximum age of files to process.  (You must specify
  574.                     a positive number in place of the XXX listed here).
  575.  
  576.            /B       Sets the option to keep the newly converted file even if
  577.                     it's bigger than the original file was.  (On/Off Option).
  578.  
  579.            /C       Sets the option to create a list of converted files. 
  580.                     (On/Off Option).
  581.  
  582.            /D=X     Sets the date stamping method to use.  (You must specify one
  583.                     of the following letters in place of the X listed here:  L
  584.                     (Last file date), O (Original date), T (Today's date).
  585.  
  586.            /E=XXX   Sets the extension to convert to.  (A valid configured
  587.                     extension must be specified in place of the XXX listed
  588.                     here).
  589.  
  590.            /F       Sets the option to attempt finding self extracting files. 
  591.                     (When this option is turned on, ShapeShifter will recognize
  592.                     .EXE files as archives if they're self extracting).  (On/Off
  593.                     Option).
  594.  
  595.            /I       Sets the option telling ShapeShifter whether it should
  596.                     redirect output from the archivers/scanner.  (On/Off
  597.                     Option).
  598.  
  599.            /K       Sets the option telling ShapeShifter whether it should keep
  600.                     the original files that are converted.  (On/Off Option).
  601.  
  602.            /L=X     Sets the activity logging level (You must specify a number
  603.                     from 0 to 5 in place of the X listed here).
  604.  
  605.            /M       Sets option of mechanical (unattended mode) operation. 
  606.                     (On/Off Option).
  607.  
  608.  
  609.           ShapeShifter - User's Guide                                    11
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.            /N       Sets the option to support conversion of archives that
  618.                     contain nested archives.  (On/Off Option).
  619.  
  620.            /O       Sets the option to tell ShapeShifter whether it should redo
  621.                     options that are already in the target format.  (On/Off
  622.                     Option).
  623.  
  624.            /P       Sets option to protect files created with PKZIP's -AV
  625.                     feature.  (On/Off Option).
  626.  
  627.            /R       Sets the option for recursion of directories when looking
  628.                     for matching files to convert.  (On/Off Option).
  629.  
  630.            /S       Option to tell ShapeShifter whether it should strip
  631.                     Read/Hidden/System attributes from files contained in
  632.                     archives.  (On/Off Option).
  633.  
  634.            /T       Test mode only option.  (On/Off Option).
  635.  
  636.            /U       Sets the option specifying whether ShapeShifter should
  637.                     update the configured BBS directory.
  638.  
  639.            /V       Sets the option to use the configured virus scanner. 
  640.                     (On/Off Option).
  641.  
  642.            /X       Set support of XMS and EMS for use by Switch! (On/Off
  643.                     Option).
  644.  
  645.  
  646.           Specifying On/Off Options
  647.  
  648.           When ShapeShifter scans the command line it looks for options by
  649.           looking for a leading '-' or '/'.  Once a '-' or '/' is found
  650.           ShapeShifter considers the next block of text (until a white space
  651.           character is hit) to be options specified by the caller.  On the
  652.           command line you can turn options on and turn options off.  The syntax
  653.           for specifying an option is as follows:
  654.  
  655.                -option[-|+][option 2[-|+]][option n...]
  656.  
  657.           Immediately after each option an optional "sign" can be used to
  658.           specify whether you want to turn the flag on (+) or off (-).  If the
  659.           sign isn't specified the option is turned on.  To look at an example
  660.           let's say you want to use ShapeShifter to strip extended attributes,
  661.           use logging level 5, not redo archives already in the target type,
  662.           convert to LZH (LHA), and recurse directories.  The following lists
  663.           several different ways to specify these options (all examples do the
  664.           same thing):
  665.  
  666.  
  667.           12                                    ShapeShifter - Introduction
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.                -s -l5 -o- -r -e=lzh
  676.  
  677.                -s+ -l5 -o- -r+ -e=lzh
  678.  
  679.                -so-r -l5 -e=lzh
  680.  
  681.           As you can see there is a great deal of flexibility in how you specify
  682.           options to ShapeShifter.  Choose the method that you feel most
  683.           comfortable with.
  684.  
  685.           In the following Chapter each of the options supported by ShapeShifter
  686.           will be explained in detail.
  687.  
  688.  
  689.  
  690.           ShapeShifter Option Descriptions
  691.  
  692.           The remainder of this chapter will be dedicated to a description
  693.           of all options supported by ShapeShifter.  The configuration
  694.           program SSCFG.EXE should be used to set the default values of
  695.           each option to what you prefer.  Command line options allow you
  696.           to override the defaults you configure as well.
  697.  
  698.           In this chapter each option will be presented in alphabetical
  699.           order using the following format:
  700.  
  701.                Screen title (fieldname as displayed by SSCFG).
  702.  
  703.                Command line specifier for this option (if available)
  704.  
  705.                Screen this option is on in SSCFG.
  706.  
  707.                Synopsis (Description of this option)
  708.  
  709.                Notes (any special limitations or notes about this option).
  710.  
  711.           Okay, enough with the introductions, I'll move on to the option
  712.           descriptions.
  713.  
  714.           -------------------------------------------------------------
  715.           Archiver Name
  716.  
  717.           Command Line Specifier
  718.  
  719.                ** Not Available **
  720.  
  721.           SSCFG Screen This Option is On
  722.  
  723.                Archiver Options
  724.  
  725.           ShapeShifter - User's Guide                                    13
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.           Synopsis
  734.  
  735.           This option specifies the name of the archiver associated with a
  736.           specific extension (see the 'Extension' option).  The name you
  737.           specify is used to display what archive type is being converted
  738.           to.
  739.  
  740.           -------------------------------------------------------------
  741.  
  742.           Author Verification
  743.  
  744.           Command Line Specifier
  745.  
  746.                ** Not Available **
  747.  
  748.           SSCFG Screen This Option is On
  749.  
  750.                Archiver Options
  751.  
  752.           Synopsis
  753.  
  754.           This option specifies whether the archiver supports author
  755.           verified files.
  756.  
  757.           Notes
  758.  
  759.           ShapeShifter currently only supports PKZIP -AV files.  Other
  760.           author verification such as ARJ's security envelopes are not
  761.           supported.  (This decision mirrors the fact that PKZIPs -AV
  762.           feature is currently the only one in wide use for BBS files).
  763.  
  764.           If you have ShapeShifter configured to leave author verified
  765.           files alone (see the 'Preserve Author Verified files" option) it
  766.           will check for -AV files when converting from an archiver type
  767.           that has the Author Verification option set to 'Yes' (On).
  768.  
  769.           WARNING:  ShapeShifter does not use an external command or
  770.           archiver to determine if a file has -AV.  Instead, it looks
  771.           direct into the file expecting it to be in ZIP format.
  772.  
  773.           -------------------------------------------------------------
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.           14                                     ShapeShifter - Option Reference
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.           Bad files directory
  793.  
  794.           Command Line Specifier
  795.  
  796.                ** Not available **
  797.  
  798.           SSCFG Screen This Option is On
  799.  
  800.                Misc Options
  801.  
  802.           Synopsis
  803.  
  804.           This option specifies a directory for ShapeShifter to move files
  805.           that it can't successfully convert.  If you specify a value here,
  806.           ShapeShifter will move all archives it encounters an error on
  807.           when converting.  (If the directory name you specify doesn't
  808.           exist, ShapeShifter will create it).
  809.  
  810.           Notes
  811.  
  812.           ShapeShifter considers a file bad if *any* error prevents it from
  813.           being properly converted.  Errors that keep a file from being
  814.           properly converted include disk errors as well as corrupt
  815.           archives.  For a complete list of circumstances that cause
  816.           ShapeShifter to consider the archive to be bad see the appendix
  817.           'How ShapeShifter Detects Corrupt Archives'.
  818.  
  819.           -------------------------------------------------------------
  820.  
  821.           Check for Self Extr.  (Check for self extracting .EXE archives)
  822.  
  823.           Command Line Specifier
  824.  
  825.                /F[+-]
  826.  
  827.           SSCFG Screen This Option is On
  828.  
  829.                Misc Options
  830.  
  831.           Synopsis
  832.  
  833.           This option tells ShapeShifter to look at .EXE files that are
  834.           encountered (as specified on the command line) as archives if
  835.           they are self extracting files.
  836.  
  837.  
  838.  
  839.  
  840.  
  841.           ShapeShifter - User's Guide                                    15
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.           Notes
  851.  
  852.           This option turns on ShapeShifter's support for self extracting
  853.           archives.  In addition to this option, there are options for each
  854.           archiver that tell ShapeShifter how to recognize a self
  855.           extracting file created by the archive program.
  856.  
  857.           WARNING:  ShapeShifter doesn't use an external command to
  858.           determine if a file is a self extractor.  It looks direct at the
  859.           files contents to determine if they are self extracting.
  860.  
  861.           -------------------------------------------------------------
  862.  
  863.           Command to Execute After All Conversions Are Complete
  864.  
  865.           Command Line Specifier
  866.  
  867.                ** Not Available **
  868.  
  869.           SSCFG Screen This Option is On
  870.  
  871.                External Command Options
  872.  
  873.           Synopsis
  874.  
  875.           This option specifies the command line that ShapeShifter will
  876.           execute after all file conversions are done.
  877.  
  878.           Notes
  879.  
  880.           This option provides a way for you to do any special cleanup
  881.           desired.
  882.  
  883.           Note that the standard fields available for command lines from
  884.           ShapeShifter don't have meaning for this command line.
  885.  
  886.           See the appendix 'Specifying Command Lines' for details on how to
  887.           specify a command line to ShapeShifter.
  888.  
  889.           -------------------------------------------------------------
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.           16                                     ShapeShifter - Option Reference
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.           Command to execute after creating an archive with this archiver
  909.  
  910.           Command Line Specifier
  911.  
  912.                ** Not Available **
  913.  
  914.           SSCFG This Option is On
  915.  
  916.                Archiver Options
  917.  
  918.           Synopsis
  919.  
  920.           This option specifies a command line that ShapeShifter will
  921.           execute after each new archive of this type is created.
  922.  
  923.           Notes
  924.  
  925.           The error-level set by this command is ignored by ShapeShifter.
  926.  
  927.           See the appendix 'Specifying Command Lines' for details on how to
  928.           specify a command line to ShapeShifter.
  929.  
  930.           -------------------------------------------------------------
  931.  
  932.           Command to execute before beginning the conversion session
  933.  
  934.           Command Line Specifier
  935.  
  936.                ** Not Available **
  937.  
  938.           SSCFG Screen This Option is On
  939.  
  940.                External Command Options
  941.  
  942.           Synopsis
  943.  
  944.           This option specifies a DOS command line that ShapeShifter should
  945.           execute before it converts the first file.
  946.  
  947.           Notes
  948.  
  949.           This provides you a way to do preliminary setup before
  950.           ShapeShifter starts it's operation.  Note that if the program you
  951.           specify returns an error level, ShapeShifter will consider it a
  952.           signal to abort the conversion.
  953.  
  954.           See the appendix 'Specifying Command Lines' for details on how to
  955.           specify a command line to ShapeShifter.
  956.  
  957.           ShapeShifter - User's Guide                                    17
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.           Note that the standard fields available for command lines from
  967.           ShapeShifter don't have meaning for this command.
  968.  
  969.           -------------------------------------------------------------
  970.  
  971.           Command to execute before creating an archive with this archiver
  972.  
  973.           Command Line Specifier
  974.  
  975.                ** Not Available **
  976.  
  977.           SSCFG Screen This Option is On
  978.  
  979.                Archiver Options
  980.  
  981.           Synopsis
  982.  
  983.           This option specifies a command line that ShapeShifter will
  984.           execute before *each* archive of this type is created.  (See the
  985.           section 'Command Lines' for details on specifying command lines
  986.           to ShapeShifter).
  987.  
  988.           Notes
  989.  
  990.           If the command returns control with an error level set,
  991.           ShapeShifter will consider the archive to be corrupt and will
  992.           abort the conversion of the file.
  993.  
  994.           See the appendix 'Specifying Command Lines' for details on how to
  995.           specify a command line to ShapeShifter.
  996.  
  997.           -------------------------------------------------------------
  998.  
  999.           Command to execute before extracting an archive with this
  1000.           archiver
  1001.  
  1002.           Command Line Specifier
  1003.  
  1004.                ** Not Available **
  1005.  
  1006.           SSCFG Screen This Option is On
  1007.  
  1008.                Archiver Options
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.           18                                     ShapeShifter - Option Reference
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.           Synopsis
  1025.  
  1026.           This option specifies a command line that should be executed
  1027.           before *each* archive of the current type is extracted.
  1028.  
  1029.           Notes
  1030.  
  1031.           If the command that is executed returns control with an error
  1032.           level set, the current archive will be considered corrupt and
  1033.           won't be converted.
  1034.  
  1035.           See the appendix 'Specifying Command Lines' for details on how to
  1036.           specify a command line to ShapeShifter.
  1037.  
  1038.           -------------------------------------------------------------
  1039.  
  1040.           Convert archives containing subdirs
  1041.  
  1042.           Command Line Specifier
  1043.  
  1044.                ** Not available **
  1045.  
  1046.           SSCFG Screen This Option is On
  1047.  
  1048.                Misc options
  1049.  
  1050.           Synopsis
  1051.  
  1052.           This option specifies whether ShapeShifter should convert
  1053.           archives that contain subdirectories.  When you set this option
  1054.           to 'Yes' (On), ShapeShifter will convert archives that contain
  1055.           subdirectories (if the archiver used to extract the file *and*
  1056.           the archiver used to create the new file support subdirs).  When
  1057.           you set this option to 'No' (Off), ShapeShifter will not convert
  1058.           files with subdirectories - even if the archivers do support
  1059.           dirs.
  1060.  
  1061.           -------------------------------------------------------------
  1062.  
  1063.           Convert to  (Extension to convert files to)
  1064.  
  1065.           Command Line Specifier
  1066.  
  1067.                /E=XXX
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.           ShapeShifter - User's Guide                                    19
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.           SSCFG Screen This Option is On
  1083.  
  1084.                Misc Options
  1085.  
  1086.           Synopsis
  1087.  
  1088.           This option specifies the file extension to convert archives to. 
  1089.           The extension you specify must be an extension that is configured
  1090.           as an archive extension using SSCFG.
  1091.  
  1092.           -------------------------------------------------------------
  1093.  
  1094.           Create Command      (Command to execute to create an archive)
  1095.  
  1096.           Command Line Specifiers
  1097.  
  1098.                ** Not Available **
  1099.  
  1100.           SSCFG Screen This Option is On
  1101.  
  1102.                Archiver Options
  1103.  
  1104.           Synopsis
  1105.  
  1106.           This option specifies the command line required to create an
  1107.           archive with the specified archiver.
  1108.  
  1109.           See the appendix 'Specifying Command Lines' for details on how to
  1110.           specify a command line to ShapeShifter.
  1111.  
  1112.           -------------------------------------------------------------
  1113.  
  1114.           Create list of files converted
  1115.  
  1116.           Command Line Specifiers
  1117.  
  1118.                /C
  1119.  
  1120.           SSCFG Screen This Option is On
  1121.  
  1122.                Misc Options
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.           20                                     ShapeShifter - Option Reference
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.           Synopsis
  1141.  
  1142.           This option specifies whether ShapeShifter should create a list
  1143.           of the files that are converted.  If this option is set to 'Yes'
  1144.           (On), ShapeShifter creates a list of files converted in the file
  1145.           specified by the 'Save Converted List in' option.
  1146.  
  1147.           -------------------------------------------------------------
  1148.  
  1149.           Date Stamping Method
  1150.  
  1151.           Command Line Specifier
  1152.  
  1153.                /D=X      (Where X is replaced by one of the options listed
  1154.                          below)
  1155.  
  1156.           SSCFG Screen This Option is On
  1157.  
  1158.                Misc Options
  1159.  
  1160.           Synopsis
  1161.  
  1162.           This option determines what file date stamping option
  1163.           ShapeShifter is going to use.  The date stamping method may be
  1164.           one of the following:
  1165.  
  1166.                Date Stamping Method          What it means
  1167.                --------------------          -------------
  1168.                0 or O                        Original date - converted
  1169.                                              files will have the same file
  1170.                                              date after the conversion as
  1171.                                              they did before ShapeShifter
  1172.                                              saw them.
  1173.  
  1174.                1 or T                        Today's date - converted files
  1175.                                              will be time stamped with the
  1176.                                              date and time they were
  1177.                                              converted.
  1178.  
  1179.                2 or L                        Last files date - converted
  1180.                                              files will be time stamped
  1181.                                              with the date and time of the
  1182.                                              latest file found within them.
  1183.  
  1184.           -------------------------------------------------------------
  1185.  
  1186.  
  1187.  
  1188.  
  1189.           ShapeShifter - User's Guide                                    21
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.           Dir File(s)
  1199.  
  1200.           Command Line Specifier
  1201.  
  1202.                ** Not Available **
  1203.  
  1204.           SSCFG Screen This Option is On
  1205.  
  1206.                Misc Options
  1207.  
  1208.           Synopsis
  1209.  
  1210.           This option specifies the BBS dir file(s) to update (update only
  1211.           occurs if you have the 'Update BBS/Dir file with new extension
  1212.           and size' option set to 'Yes').
  1213.  
  1214.           You may specify multiple filespecs in this field (separated by a
  1215.           space), and any of the filespecs may contain wildcards.
  1216.  
  1217.           Notes
  1218.  
  1219.           When you have ShapeShifter configured to update a BBS file
  1220.           listing, *all* files matching the specs you specify in this field
  1221.           will be searched for files matching those that were converted. 
  1222.           For faster operation you should not specify filespecs that will
  1223.           cause excessive files to be searched.
  1224.  
  1225.           -------------------------------------------------------------
  1226.  
  1227.           Dir Type
  1228.  
  1229.           Command Line Specifier
  1230.  
  1231.                ** Not Available **
  1232.  
  1233.           SSCFG Screen This Option is On
  1234.  
  1235.                Misc Options
  1236.  
  1237.           Synopsis
  1238.  
  1239.           This option specifies the type of BBS directory file that
  1240.           ShapeShifter should update.  (You must set the 'Update BBS/Dir
  1241.           file with new Extension and Size' option to 'Yes' to tell
  1242.           ShapeShifter to update the file).
  1243.  
  1244.           The following dir types are currently supported by ShapeShifter:
  1245.  
  1246.  
  1247.           22                                     ShapeShifter - Option Reference
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.                Auntie (v 511 format)
  1256.                PC Board (v14.5 format)
  1257.                ProDoor
  1258.                Quick BBS
  1259.                TBBS
  1260.                User Defined
  1261.  
  1262.           Notes
  1263.  
  1264.           The support for defined BBS types is current as of the release of
  1265.           this software.  In order to provide support for future versions
  1266.           with a different format, or for a type not listed above, you may
  1267.           use the user defined type to tell ShapeShifter about the DIR file
  1268.           format.
  1269.  
  1270.           It should be noted that ShapeShifter can't support every possible
  1271.           file format.  To be able to update a BBS dir file, ShapeShifter
  1272.           has three requirements:
  1273.  
  1274.                The column that filenames start in must be reserved for the
  1275.                filename and not overlaid with other data on any line.  If
  1276.                data other than the filename can lie in the starting
  1277.                filename column, ShapeShifter may incorrectly think it found
  1278.                a file when it didn't.
  1279.  
  1280.                A file size field must be present, and it must reside on the
  1281.                same line as the filename.  In addition, it must be non-
  1282.                zero.
  1283.  
  1284.                The filename and size must each start in a fixed column.
  1285.  
  1286.           To update a user defined BBS file listing type, you must specify
  1287.           the file and size starting column information.  See the following
  1288.           options to specify the layout of a user defined file listing:
  1289.  
  1290.                File Start, Len
  1291.                Size Start, Len
  1292.           and  R. Just
  1293.  
  1294.           -------------------------------------------------------------
  1295.  
  1296.           Extension  (Archive Extension)
  1297.  
  1298.           Command Line Specifier
  1299.  
  1300.                ** Not Available **
  1301.  
  1302.  
  1303.  
  1304.  
  1305.           ShapeShifter - User's Guide                                    23
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.           SSCFG Screen This Option is On
  1315.  
  1316.                Archiver Options
  1317.  
  1318.           Synopsis
  1319.  
  1320.           This option specifies the extension used by a given archiver (if
  1321.           you're looking for the extension to convert to, see the 'Convert
  1322.           To' option).
  1323.  
  1324.           The extension you specify is used by ShapeShifter to identify
  1325.           files created by this archiver.
  1326.  
  1327.           -------------------------------------------------------------
  1328.  
  1329.           Extract Command     (Command to extract files from an archive)
  1330.  
  1331.           Command Line Specifier
  1332.  
  1333.                ** Not Available **
  1334.  
  1335.           SSCFG Screen This Option is On
  1336.  
  1337.                Archiver Options
  1338.  
  1339.           Synopsis
  1340.  
  1341.           This option specifiers the command line required to extract files
  1342.           using the specified archiver.
  1343.  
  1344.           See the appendix 'Specifying Command Lines' for details on how to
  1345.           specify a command line to ShapeShifter.
  1346.  
  1347.           -------------------------------------------------------------
  1348.  
  1349.           File Attributes     (Does the archiver support file attributes)
  1350.  
  1351.           Command Line Specifier
  1352.  
  1353.                ** Not Available **
  1354.  
  1355.           SSCFG Screen This Option is On
  1356.  
  1357.                Archiver Options
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.           24                                     ShapeShifter - Option Reference
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.           Synopsis
  1373.  
  1374.           This option specifies whether the current archiver supports
  1375.           Hidden/System/Read only attributes.
  1376.  
  1377.           Notes
  1378.  
  1379.           If you have ShapeShifter configured to strip attributes (see the
  1380.           'Strip attributes' option), this option is ignored.
  1381.  
  1382.           -------------------------------------------------------------
  1383.  
  1384.           File Offset    (Offset in an EXE file to look for the self
  1385.           extractor identifying string)
  1386.  
  1387.           Command Line Specifier
  1388.  
  1389.                ** Not Available **
  1390.  
  1391.           SSCFG Screen This Option is On
  1392.  
  1393.                Archive Options
  1394.  
  1395.           Synopsis
  1396.  
  1397.           This option specifies the offset that the SFX Id string can be
  1398.           found.  The offset can be a number between 255 and -255.  The
  1399.           various values have the following meaning:
  1400.  
  1401.                Value     Meaning
  1402.                -----     -------
  1403.                  0       Tells ShapeShifter to search the first 246 bytes
  1404.                          of the .EXE header.  Most programs that create
  1405.                          self extracting files put their copyright in this
  1406.                          area.  When the file offset for a string is 0,
  1407.                          ShapeShifter will search the entire first 246
  1408.                          bytes for the SFX ID String specified.  Using this
  1409.                          method to detect a SFX file makes it possible to
  1410.                          detect future versions created by the archiver
  1411.                          that may not put the information in the exact same
  1412.                          spot.
  1413.  
  1414.                 > 0      A value that is greater than zero causes
  1415.                          ShapeShifter to look for the SFX Id String at the
  1416.                          specified offset from the beginning of the file. 
  1417.                          The first byte in the .EXE file is considered as
  1418.                          being at offset 1.
  1419.  
  1420.  
  1421.           ShapeShifter - User's Guide                                    25
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.                 < 0      A value that is below zero causes ShapeShifter to
  1430.                          look for the SFX Id String at the specified offset
  1431.                          from the end of the file.  The last byte in the
  1432.                          file is considered as being at offset -1.
  1433.  
  1434.           -------------------------------------------------------------
  1435.  
  1436.           File Start,Len
  1437.  
  1438.           Command Line Specifier
  1439.  
  1440.                ** Not Available **
  1441.  
  1442.           SSCFG Screen This Option is On
  1443.  
  1444.                Misc Options
  1445.  
  1446.           Synopsis
  1447.  
  1448.           This option specifies the starting column and length of the
  1449.           filename field in the BBS file listing.  The value you specify
  1450.           here is only used when you set the 'Dir Type' option to user
  1451.           defined.
  1452.  
  1453.           -------------------------------------------------------------
  1454.  
  1455.           Keep original archive  (Keep the original archive in addition to
  1456.           the newly converted version)
  1457.  
  1458.           Command Line Specifier
  1459.  
  1460.                /K[+-]
  1461.  
  1462.           SSCFG Screen This Option is On
  1463.  
  1464.                Misc Options
  1465.  
  1466.           Synopsis
  1467.  
  1468.           This option specifies whether or not ShapeShifter should keep the
  1469.           original archive file after conversion.  If you set this option
  1470.           to 'Yes' (On) both the original archive and the newly created
  1471.           archive will be kept on the disk.  You should set this option to
  1472.           'No' (Off) to cause the original archive to be removed after
  1473.           being successfully converted.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.           26                                     ShapeShifter - Option Reference
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.           Notes
  1489.  
  1490.           It isn't possible for ShapeShifter to honor the redo archives
  1491.           option when this option is set (since redoing an archive implies
  1492.           you will modify the original).  When this option is set it
  1493.           automatically overrides the Redo option.
  1494.  
  1495.           -------------------------------------------------------------
  1496.  
  1497.           Keep original file if it's smaller  (Keep the original archive if
  1498.           the new format creates a bigger file)
  1499.  
  1500.           Command Line Specifier
  1501.  
  1502.                /B[+-]
  1503.  
  1504.           SSCFG Screen This Option is On
  1505.  
  1506.                Misc Options
  1507.  
  1508.           Synopsis
  1509.  
  1510.           This option specifies whether or not ShapeShifter should keep the
  1511.           original archive file if the new format creates a bigger file. 
  1512.           If this option is on and a newly created file is bigger than the
  1513.           original, the new file will be deleted and the original archive
  1514.           will be kept.
  1515.  
  1516.           -------------------------------------------------------------
  1517.  
  1518.           Log File
  1519.  
  1520.           Command Line Specifier
  1521.  
  1522.                ** Not Available **
  1523.  
  1524.           SSCFG Screen This Option is On
  1525.  
  1526.                Misc Options
  1527.  
  1528.           Synopsis
  1529.  
  1530.           This option specifies the file name (or logical device) that
  1531.           ShapeShifter should log information about files converted to.
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.           ShapeShifter - User's Guide                                    27
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.           Notes
  1547.  
  1548.           The logging level option must be set to non-zero for activity
  1549.           logging to occur.
  1550.  
  1551.           The file you specify may be a logical DOS device if desired.  For
  1552.           instance, PRN causes output to go to the printer attached to your
  1553.           computer on LPT1.
  1554.  
  1555.           If the file you specify already exists, ShapeShifter will append
  1556.           the logging information to the end of the file.
  1557.  
  1558.           -------------------------------------------------------------
  1559.  
  1560.           Logging Level
  1561.  
  1562.           Command Line Specifier
  1563.  
  1564.                /L=X      (Where X is replaced by a number from 0 to 5)
  1565.  
  1566.           SSCFG Screen This Option is On
  1567.  
  1568.                Misc Options
  1569.  
  1570.           Synopsis
  1571.  
  1572.           This option specifies the activity logging level for ShapeShifter
  1573.           to use.  When set to a non-zero value and a log file is specified
  1574.           (see the 'Log File' option), ShapeShifter will log activity as it
  1575.           converts files.  The following table shows the various log level
  1576.           values and what they do:
  1577.  
  1578.                Level     Result
  1579.                -----     ------
  1580.                  0       No activity logging is performed
  1581.  
  1582.                  1       Lists file names converted in addition to errors
  1583.                          encountered.
  1584.  
  1585.                  2       File sizes (before and after are added to data
  1586.                          logged from lower levels)
  1587.  
  1588.                  3       Internal (nested) archive names that were
  1589.                          converted are added to the data from lower logging
  1590.                          levels.
  1591.  
  1592.  
  1593.  
  1594.  
  1595.           28                                     ShapeShifter - Option Reference
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.                  4       Totals by subdirectory are added to the data from
  1605.                          lower log levels.
  1606.  
  1607.                  5       Adds overall totals to the other log levels.
  1608.  
  1609.           -------------------------------------------------------------
  1610.  
  1611.           Max age of files to convert
  1612.  
  1613.           Command Line Specifier
  1614.  
  1615.                /A=X      (Where X is replaced by the number of days)
  1616.  
  1617.           SSCFG Screen This Option is On
  1618.  
  1619.                Misc Options
  1620.  
  1621.           Synopsis
  1622.  
  1623.           This option sets the maximum age of files to be converted.  If
  1624.           you set this option to a non-zero value, only files that are
  1625.           newer than the conversion date minus the maximum age will be
  1626.           converted.  The following examples show how this option works:
  1627.  
  1628.                Max Age Setting          What ShapeShifter Does
  1629.                ---------------          ----------------------
  1630.                     0                   Converts all archives that match
  1631.                                         the specified filespecs -
  1632.                                         regardless of age.
  1633.  
  1634.                     1                   Only converts archives that match
  1635.                                         the specified filespecs and have a
  1636.                                         file date of yesterday or later.
  1637.  
  1638.                     2                   Only converts archives that match
  1639.                                         the specified filespecs and have a
  1640.                                         file date no more than 2 days old.
  1641.  
  1642.           -------------------------------------------------------------
  1643.  
  1644.           Memory to make available  (Amount of memory to free for archiver)
  1645.  
  1646.           Command Line Specifier
  1647.  
  1648.                ** Not Available **
  1649.  
  1650.  
  1651.  
  1652.  
  1653.           ShapeShifter - User's Guide                                    29
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.           SSCFG Screen This Option is On
  1663.  
  1664.                Archiver Options
  1665.  
  1666.           Synopsis
  1667.  
  1668.           This option specifies the amount of memory to make available for
  1669.           the archiver when Switch! is used (see the 'Use Switch!' option). 
  1670.  
  1671.           Notes
  1672.  
  1673.           A value of 640 as well as 0 causes the maximum amount of memory
  1674.           to be freed for running the current archiver.
  1675.  
  1676.           -------------------------------------------------------------
  1677.  
  1678.           Preserve Author Verified files
  1679.  
  1680.           Command Line Specifier
  1681.  
  1682.                /L
  1683.  
  1684.           SSCFG Screen This Option is On
  1685.  
  1686.                Misc Options
  1687.  
  1688.           Synopsis
  1689.  
  1690.           This option specifies whether ShapeShifter should leave -AV files
  1691.           (created by PKZIP) alone when it converts files.
  1692.  
  1693.           -------------------------------------------------------------
  1694.  
  1695.           R. Just  (Is the file size field right justified)
  1696.  
  1697.           Command Line Specifier
  1698.  
  1699.                ** Not Available **
  1700.  
  1701.           SSCFG Screen This Option is On
  1702.  
  1703.                Misc Options
  1704.  
  1705.           Synopsis
  1706.  
  1707.           This option specifies whether or not the file size field is right
  1708.           justified when you use a user defined dir type.  (See the 'Dir
  1709.           Type' option).
  1710.  
  1711.           30                                     ShapeShifter - Option Reference
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.           -------------------------------------------------------------
  1720.  
  1721.           Recurse Archives  (Convert archives that are nested inside other
  1722.           archives)
  1723.  
  1724.           Command Line Specifier
  1725.  
  1726.                /N
  1727.  
  1728.           SSCFG Screen This Option is On
  1729.  
  1730.                Misc Options
  1731.  
  1732.           Synopsis
  1733.  
  1734.           This option specifies whether archives inside files that are
  1735.           converted should also be converted.  If this option is set to
  1736.           'No' (Off), any archives inside a file being converted will be
  1737.           untouched.  If this option is set to 'Yes' (On), archives within
  1738.           files being converted will also be converted.  ShapeShifter can
  1739.           properly handle nested archives to virtually any level.
  1740.  
  1741.           Notes
  1742.  
  1743.           If you set this option to 'No', ShapeShifter will still
  1744.           successfully convert (if no other errors occur) archives that
  1745.           contain nested archives.  Be aware that archives within converted
  1746.           files will be left in their original format unless you turn this
  1747.           option on though.
  1748.  
  1749.           -------------------------------------------------------------
  1750.  
  1751.           Recurse Subdirs  (Recurse subdirectories looking for matching
  1752.           files to convert)
  1753.  
  1754.           Command Line Specifier
  1755.  
  1756.                /R
  1757.  
  1758.           SSCFG Screen This Option is On
  1759.  
  1760.                Misc Options
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.           ShapeShifter - User's Guide                                    31
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.           Synopsis
  1779.  
  1780.           This option specifies whether ShapeShifter should search
  1781.           subdirectories for the specified files as it looks for files to
  1782.           convert.  If you set this option to 'Yes' (On), ShapeShifter
  1783.           searches the child directories of each file specification looking
  1784.           for matching files.  If you set this option to 'No' (Off),
  1785.           ShapeShifter will only look in the directories specified for
  1786.           filespecs.
  1787.  
  1788.           Notes
  1789.  
  1790.           The file specifications you use with ShapeShifter are honored
  1791.           even when this option is set.  Consider the following examples:
  1792.  
  1793.                File Spec           What ShapeShifter does with Recurse On
  1794.                ---------           --------------------------------------
  1795.                *.ZIP               Searches the current directory as well
  1796.                                    as child directories for .ZIP files to
  1797.                                    convert.
  1798.  
  1799.                \*.*                Searches the entire current drive for
  1800.                                    files of any of the configured archive
  1801.                                    types to convert.
  1802.  
  1803.           -------------------------------------------------------------
  1804.  
  1805.           Redirect I/O  (Redirect I/O from the virus scanners and
  1806.           archivers)
  1807.  
  1808.           Command Line Specifier
  1809.  
  1810.                /I
  1811.  
  1812.           SSCFG Screen This Option Is On
  1813.  
  1814.                Misc Options
  1815.  
  1816.           Synopsis
  1817.  
  1818.           This option controls whether or not ShapeShifter attempts to
  1819.           redirect the output from archivers and the virus scanner.
  1820.  
  1821.           Note
  1822.  
  1823.           ShapeShifter's output redirection requires output to be DOS
  1824.           redirectable.   (Note, ShapeShifter *can* successfully redirect
  1825.           output from LHA and similar programs!).
  1826.  
  1827.           32                                     ShapeShifter - Option Reference
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.           Although ShapeShifter can redirect output, it isn't really
  1836.           necessary.  ShapeShifter can cause all but direct screen writes
  1837.           to be within it's defined window area.
  1838.  
  1839.           ------------------------------------------------------------
  1840.  
  1841.           Redo archives that are already the target type
  1842.  
  1843.           Command Line Specifier
  1844.  
  1845.                /O
  1846.  
  1847.           SSCFG Screen This Option is On
  1848.  
  1849.                Misc Options
  1850.  
  1851.           Synopsis
  1852.  
  1853.           This option controls whether or not ShapeShifter will recreate
  1854.           archives that are already in the target format.
  1855.  
  1856.           Notes
  1857.  
  1858.           Recreation of archives already in the target format is a handy
  1859.           way to remove BBS ad comments in addition to allowing you to
  1860.           insure the maximum compression of the archiver was used.
  1861.  
  1862.           -------------------------------------------------------------
  1863.  
  1864.           Save Converted List in
  1865.  
  1866.           Command Line Specifier
  1867.  
  1868.                ** Not Available **
  1869.  
  1870.           SSCFG Screen This Option is On
  1871.  
  1872.                Misc Options
  1873.  
  1874.           Synopsis
  1875.  
  1876.           This option specifies the filename (or logical device) for
  1877.           ShapeShifter to save the list of filenames that were converted. 
  1878.  
  1879.           Notes
  1880.  
  1881.           You may specify a filename or a DOS device for output of the
  1882.           converted files list.  For example, PRN causes output to go to
  1883.           the device attached to LPT1.
  1884.  
  1885.           ShapeShifter - User's Guide                                    33
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.           If you specify the name of a file that already exists,
  1894.           ShapeShifter will append the converted file names to the end of
  1895.           the file.
  1896.  
  1897.           -------------------------------------------------------------
  1898.  
  1899.           Scan All Files
  1900.  
  1901.           Command Line Specifier
  1902.  
  1903.                ** Not Available **
  1904.  
  1905.           SSCFG Screen This Option is On
  1906.  
  1907.                Misc Options
  1908.  
  1909.           Synopsis
  1910.  
  1911.           This option tells ShapeShifter whether it should scan all files
  1912.           in an archive including those in a protected -AV file or in an
  1913.           internal archive that isn't being converted.
  1914.  
  1915.           Notes
  1916.  
  1917.           Setting this option to Yes will cause ShapeShifter to expand
  1918.           files it doesn't intend to convert for purposes of virus scanning
  1919.           (assuming you have it configured to scan for virii).  When this
  1920.           option is set to Yes, ShapeShifter expands -AV files even if you
  1921.           have the option set to protect them.  In addition, it will expand
  1922.           internal archives for scanning regardless the setting of the
  1923.           recurse archives option.
  1924.  
  1925.           The files that are expanded as a result of this option but
  1926.           normally wouldn't be converted will not be replaced after the
  1927.           contents are scanned for virii (i.e. protected -AV files and
  1928.           internal archives when recurse archives is off).
  1929.  
  1930.           If this option is turned off, ShapeShifter won't even attempt to
  1931.           expand the contents of protected files.
  1932.  
  1933.           -------------------------------------------------------------
  1934.  
  1935.           Scanner Command
  1936.  
  1937.           Command Line Specifier
  1938.  
  1939.                ** Not Available **
  1940.  
  1941.  
  1942.  
  1943.           34                                     ShapeShifter - Option Reference
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.           SSCFG Screen This Option is On
  1953.  
  1954.                Misc Options
  1955.  
  1956.           Synopsis
  1957.  
  1958.           This option allows you to specify the DOS command line for the
  1959.           virus scanner of your choice.
  1960.  
  1961.           Notes
  1962.  
  1963.           See the appendix 'Specifying Command Lines' for information on
  1964.           special features available in ShapeShifter for command line
  1965.           specification.
  1966.  
  1967.           ShapeShifter requires a virus scanner that sets the DOS error
  1968.           level if a virus is detected (if you desire to use a virus
  1969.           scanner).  The scanner should use an exit code (errorlevel) of 0
  1970.           if there were no viral infections detected.  A non-zero exit code
  1971.           is interpreted by ShapeShifter as saying one or more of the files
  1972.           are infected.
  1973.  
  1974.           -------------------------------------------------------------
  1975.  
  1976.           Scanner supports subdirs
  1977.  
  1978.           Command Line Specifier
  1979.  
  1980.                ** Not Available **
  1981.  
  1982.           SSCFG Screen This Option is On
  1983.  
  1984.                Misc Options
  1985.  
  1986.           Synopsis
  1987.  
  1988.           This option specifies whether or not the virus scanner you're
  1989.           using supports automatic searching of child directories.
  1990.  
  1991.           Notes
  1992.  
  1993.           ShapeShifter doesn't require a scanner that supports subdirs.  If
  1994.           you set this option to 'No' (Off), ShapeShifter will call the
  1995.           scanner to look at files in each directory as required.  Setting
  1996.           this option to 'Yes' (On) may be faster for virus scanners that
  1997.           support dirs.
  1998.  
  1999.           -------------------------------------------------------------
  2000.  
  2001.           ShapeShifter - User's Guide                                    35
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.           SFX Id String  (Self extracting identification string in an EXE
  2010.           file for this archiver)
  2011.  
  2012.           Command Line Specifier
  2013.  
  2014.                ** Not Available **
  2015.  
  2016.           SSCFG Screen This Option is On
  2017.  
  2018.                Archive Options
  2019.  
  2020.           Synopsis
  2021.  
  2022.           This option specifies the string that this archiver puts in the
  2023.           EXE file when it creates a self extracting file.  This option
  2024.           works with the File Offset option to allow ShapeShifter a method
  2025.           of detecting self extracting files.
  2026.  
  2027.           The flexibility to specify how these files are detected give you
  2028.           the capability to add support for future archive programs that
  2029.           create them.
  2030.  
  2031.           -------------------------------------------------------------
  2032.  
  2033.           Size Start,Len
  2034.  
  2035.           Command Line Specifier
  2036.  
  2037.                ** Not Available **
  2038.  
  2039.           SSCFG Screen This Option is On
  2040.  
  2041.                Misc Options
  2042.  
  2043.           Synopsis
  2044.  
  2045.           This option sets the starting column and length of the file size
  2046.           field in a user defined BBS listing.  ShapeShifter will only use
  2047.           the values you specify here if you set the 'Dir Type' option to
  2048.           user defined.
  2049.  
  2050.           Take a look at the 'R. Just' option to specify whether or not the
  2051.           file size field is right justified.
  2052.  
  2053.           -------------------------------------------------------------
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.           36                                     ShapeShifter - Option Reference
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.           Strip attributes (HSR)
  2069.  
  2070.           Command Line Specifier
  2071.  
  2072.                /S
  2073.  
  2074.           SSCFG Screen This Option is On
  2075.  
  2076.                Misc Options
  2077.  
  2078.           Synopsis
  2079.  
  2080.           This option allows you to tell ShapeShifter to remove Hidden,
  2081.           System, and Read Only attributes found on files that are inside
  2082.           archives being converted.
  2083.  
  2084.           If you set this option to 'Yes' (On), ShapeShifter will remove
  2085.           all hidden/system/read only file attributes.
  2086.  
  2087.           Notes
  2088.  
  2089.           If the archiver you're converting to doesn't support file
  2090.           attributes and this option is off, ShapeShifter will report an
  2091.           error on attempts to convert any archive that contains files with
  2092.           one of the attributes set.  If on the otherhand you turn this
  2093.           option on, ShapeShifter will remove the file attributes thus
  2094.           allowing the archiver to handle the files.
  2095.  
  2096.           -------------------------------------------------------------
  2097.  
  2098.           SubDirs        (Does the archiver support subdirs)
  2099.  
  2100.           Command Line Specifier
  2101.  
  2102.                ** Not Available **
  2103.  
  2104.           SSCFG Screen This Option is On
  2105.  
  2106.                Archiver Options
  2107.  
  2108.           Synopsis
  2109.  
  2110.           This option specifies whether the current archiver supports
  2111.           subdirectories within archives.
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.           ShapeShifter - User's Guide                                    37
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.           Notes
  2127.  
  2128.           If you have ShapeShifter configured to support subdirs (see the
  2129.           'Convert archives containing subdirs' option) and this option is
  2130.           set to 'No' (Off), ShapeShifter will not allow conversion of
  2131.           archives with subdirs when converting to this type of archive. 
  2132.           Note that if ShapeShifter isn't configured to support conversion
  2133.           of archives with subdirs, this option is ignored.
  2134.  
  2135.           -------------------------------------------------------------
  2136.  
  2137.           Switch! to EMS
  2138.  
  2139.           Command Line Specifier
  2140.  
  2141.                /X   (Note:  This command line specifier also enables use of
  2142.                     XMS as a first choice)
  2143.  
  2144.           SSCFG Screen This Option is On
  2145.  
  2146.                Misc Options
  2147.  
  2148.           Synopsis
  2149.  
  2150.           This option controls whether or not ShapeShifter uses EMS when
  2151.           Switch!ing memory.
  2152.  
  2153.           Notes
  2154.  
  2155.           Switch! is only used if you configure it to be used for a given
  2156.           archiver.  (See the 'Use Switch' option description).
  2157.  
  2158.           -------------------------------------------------------------
  2159.  
  2160.           Switch! to XMS
  2161.  
  2162.           Command Line Specifier
  2163.  
  2164.                /X   (Note:  This command line specifier also enables use of
  2165.                     EMS as a second choice)
  2166.  
  2167.           SSCFG Screen This Option is On
  2168.  
  2169.                Misc Options
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.           38                                     ShapeShifter - Option Reference
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.           Synopsis
  2185.  
  2186.           This option controls whether or not ShapeShifter uses XMS when
  2187.           Switch!ing memory.
  2188.  
  2189.           Notes
  2190.  
  2191.           Switch! is only used if you configure it to be used for a given
  2192.           archiver.  (See the 'Use Switch' option description).
  2193.  
  2194.           -------------------------------------------------------------
  2195.  
  2196.           Test Only
  2197.  
  2198.           Command Line Specifier
  2199.  
  2200.                /T
  2201.  
  2202.           SSCFG Screen This Option is On
  2203.  
  2204.                Misc Options
  2205.  
  2206.           Synopsis
  2207.  
  2208.           When this option is set to 'Yes' (On), ShapeShifter will go
  2209.           through all the steps to convert the files you specify without
  2210.           actually creating or removing the old files.
  2211.  
  2212.           -------------------------------------------------------------
  2213.  
  2214.           Update BBS/Dir File With New Extension and Size
  2215.  
  2216.           Command Line Specifier
  2217.  
  2218.                /U
  2219.  
  2220.           SSCFG Screen This Option is On
  2221.  
  2222.                Misc Option
  2223.  
  2224.           Synopsis
  2225.  
  2226.           This option specifies whether ShapeShifter should update a BBS
  2227.           type DIR file with the new file extensions and sizes.  If you set
  2228.           this option to 'Yes' (On), ShapeShifter will update the file(s)
  2229.           specified (see the 'Dir File(s)' option).
  2230.  
  2231.  
  2232.  
  2233.           ShapeShifter - User's Guide                                    39
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.           Notes
  2243.  
  2244.           ShapeShifter uses several options to determine how to locate file
  2245.           names and sizes in the BBS directory for updating.  See the 'Dir
  2246.           Type' option description.
  2247.  
  2248.           -------------------------------------------------------------
  2249.  
  2250.           Use 43/50 Line Mode
  2251.  
  2252.           Command Line Specifier
  2253.  
  2254.                /4
  2255.  
  2256.           SSCFG Screen This Option is On
  2257.  
  2258.                Misc Options
  2259.  
  2260.           Synopsis
  2261.  
  2262.           This option specifies whether ShapeShifter should operate using
  2263.           43/50 line mode instead of the standard 25 lines.
  2264.  
  2265.           Notes
  2266.  
  2267.           This option is only available with an EGA, VGA, or equivalent.
  2268.  
  2269.           -------------------------------------------------------------
  2270.  
  2271.           Use Switch!
  2272.  
  2273.           Command Line Specifier
  2274.  
  2275.                ** Not Available **
  2276.  
  2277.           SSCFG Screen This Option is On
  2278.  
  2279.                Archiver Options
  2280.  
  2281.           Synopsis
  2282.  
  2283.           This option specifies whether ShapeShifter should use Switch! for
  2284.           the current archiver.  Switch! is a special function that allows
  2285.           ShapeShifter to free virtually all the memory it is using to make
  2286.           it available for running the archiver.
  2287.  
  2288.  
  2289.  
  2290.  
  2291.           40                                     ShapeShifter - Option Reference
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.           Notes
  2301.  
  2302.           This option is closely related to several other options:
  2303.  
  2304.                Memory to make available
  2305.  
  2306.                Switch! to EMS
  2307.  
  2308.                Switch! to XMS
  2309.  
  2310.           -------------------------------------------------------------
  2311.  
  2312.           Use Virus Scanner
  2313.  
  2314.           Command Line Specifier
  2315.  
  2316.                /V
  2317.  
  2318.           SSCFG Screen This Option is On
  2319.  
  2320.                Misc Options
  2321.  
  2322.           Synopsis
  2323.  
  2324.           This option specifies whether ShapeShifter should use the
  2325.           configured virus scanner (see the 'Scanner Command' option).  If
  2326.           you set this option to 'Yes' (On), ShapeShifter will use the
  2327.           virus scanner you specified with SSCFG.
  2328.  
  2329.           Notes
  2330.  
  2331.           ShapeShifter requires a virus scanner that sets the DOS error
  2332.           level if a virus is detected (if you desire to use a virus
  2333.           scanner).  The scanner should use an exit code (errorlevel) of 0
  2334.           if there were no viral infections detected.  A non-zero exit code
  2335.           is interpreted by ShapeShifter as saying one or more of the files
  2336.           are infected.
  2337.  
  2338.           -------------------------------------------------------------
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.           ShapeShifter - User's Guide                                    41
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.                                                                  Appendices
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.           
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.           Appendix A - How ShapeShifter Detects Corrupt Archives.
  2417.  
  2418.           There are many circumstances that can keep an archive from being
  2419.           successfully converted.  The following is an alphabetic list by
  2420.           error message (as displayed on the ShapeShifter conversion
  2421.           screen) detailing all valid reasons for stoppage of a conversion,
  2422.           and whether the file will be considered corrupt by ShapeShifter
  2423.           (i.e. a corrupt file is moved to the configured bad files
  2424.           directory).  Note that ShapeShifter will *NOT* delete a file for
  2425.           being corrupt - this is a decision best left to the user!
  2426.  
  2427.                                                        Archive Moved
  2428.                Reason for failure                      To Bad Files Dir
  2429.                ------------------                      ----------------
  2430.                (-AV File)
  2431.                Author verification was detected in     *NO*
  2432.                the file and you have ShapeShifter
  2433.                configured to preserve author verified
  2434.                files.  (This is not considered as a 
  2435.                corrupt archive - it just keeps 
  2436.                ShapeShifter from modifying the file).
  2437.  
  2438.                (AttrAbort)
  2439.                File attributes are contained in the    Yes
  2440.                archive to be converted when the type
  2441.                of archive you're converting to isn't
  2442.                configured as supporting attributes 
  2443.                (and you don't have ShapeShifter set
  2444.                to strip attributes).
  2445.  
  2446.                (Corrupt)
  2447.                Archiver returns with an error level    Yes
  2448.                set when ShapeShifter attempts to 
  2449.                extract the contents of a file.
  2450.  
  2451.                (CreateErr)
  2452.                The archiver returned with an error     Yes
  2453.                level set when ShapeShifter attempted
  2454.                to create the new file.
  2455.  
  2456.                (CreateErr)
  2457.                The target file already exists.         Yes
  2458.  
  2459.                (CreateErr)
  2460.                The expected target file couldn't be    Yes
  2461.                found after the archive creation
  2462.                command was completed.
  2463.  
  2464.  
  2465.           ShapeShifter - User's Guide                                    43
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.                (DirAbort)
  2474.                Subdirectories were detected in the     Yes
  2475.                archive when the type of archive 
  2476.                you're converting to isn't configured
  2477.                as supporting dirs, or ShapeShifter is
  2478.                configured to not allow conversion of
  2479.                files containing subdirs.
  2480.  
  2481.                (EXEC Err)
  2482.                Failure to spawn the archiver, virus    Yes
  2483.                scanner, or a user command (i.e. not
  2484.                enough memory, command not found, etc)
  2485.  
  2486.                (INFECTED!)
  2487.                Virus Scanner returns with an error     Yes
  2488.                level set.
  2489.  
  2490.                (RedoAbort)
  2491.                When attempting to redo an archive      Yes
  2492.                that was already in the target format,
  2493.                ShapeShifter was unable to generate a 
  2494.                unique filename.  (It tries 1000
  2495.                different extensions when attempting to
  2496.                create a temp file for the conversion).
  2497.  
  2498.                (Scan Only)
  2499.                The file was not converted because      *NO*
  2500.                it was looked at for purposes of
  2501.                virus scanning only.  The file is
  2502.                protected from conversion based on
  2503.                the options that are set.
  2504.  
  2505.                (Size Skip)
  2506.                The conversion of the file is skipped   *NO*
  2507.                because the new file is larger than 
  2508.                the original.  The original file will
  2509.                be kept.
  2510.  
  2511.                (Skipped)
  2512.                Skipped file because it is already      *NO*
  2513.                in the target format and ShapeShifter
  2514.                isn't configured to redo archives 
  2515.                already in the target format.
  2516.  
  2517.                (SysError)
  2518.                Internal program error                  Yes
  2519.                (This occurs if a system or internal
  2520.                error in ShapeShifter occurs).
  2521.  
  2522.  
  2523.           44                                        ShapeShifter Appendices
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.                (UserAbort)
  2532.                User configured program returns with    Yes
  2533.                an error level set.
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.           ShapeShifter - User's Guide                                    45
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.           Appendix B - Archivers, Scanners, and User Programs Supported by
  2590.           ShapeShifter
  2591.  
  2592.           ShapeShifter supports a wide variety of programs including user
  2593.           commands that allow you to customize operation for a variety of
  2594.           situations.  There is one *major* requirement for a program to
  2595.           work properly with ShapeShifter - use of the DOS error level
  2596.           (exit code).  ShapeShifter expects commands to return with the
  2597.           error level set if an error is detected (it doesn't matter what
  2598.           the error level is set to - as long as it's non-zero).  Likewise,
  2599.           ShapeShifter expects the error level to be cleared (set to zero)
  2600.           when an error doesn't occur.
  2601.  
  2602.           Any program that returns control to ShapeShifter with a non-zero
  2603.           errorlevel set without an error condition can't be used.  On the
  2604.           other hand, if a program always returns control with the error
  2605.           level cleared, ShapeShifter will work with the program but will
  2606.           be crippled in that it can't detect when an archive is corrupt.
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.           46                                        ShapeShifter Appendices
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.           Appendix C - ShapeShifter Error Messages
  2648.  
  2649.           This appendix gives a list (alphabetical) of the common
  2650.           ShapeShifter error messages.  Each message is accompanied by a
  2651.           short description describing what the message means.
  2652.  
  2653.  
  2654.           Abort ShapeShifter?
  2655.                This message is displayed when the ESCape key is pressed
  2656.                during a conversion session. 
  2657.  
  2658.           Aborted: Archive creation error
  2659.                This message occurs when the archiver fails to create the
  2660.                archive as expected.  Note that this message is only used
  2661.                when you have activity logging turned on.
  2662.  
  2663.           Aborted: Contains subdirs
  2664.                This message occurs when ShapeShifter fails to convert an
  2665.                archive because it contains subdirs and the archive being
  2666.                converted to doesn't support dirs (or you have ShapeShifter
  2667.                configured not to support them).  Note that this message is
  2668.                only used when you have activity logging turned on.
  2669.  
  2670.           Aborted: Contains attributes
  2671.                This message occurs when ShapeShifter fails to convert an
  2672.                archive because one or more files in the archive have an
  2673.                attribute set, and the archive type you're converting to
  2674.                isn't configured as supporting attributes.  You may also
  2675.                specify the strip attributes option to overcome this
  2676.                problem.  Note that this message is only used when you have
  2677.                activity logging turned on.
  2678.  
  2679.           Aborted: Internal error
  2680.                This message occurs when an internal error in ShapeShifter
  2681.                kept the archive from being properly converted.  Note that
  2682.                this message is only used when you have activity logging
  2683.                turned on.
  2684.  
  2685.           Aborted: User program canceled
  2686.                This message occurs when a user configured program returns a
  2687.                non-zero exit code (causing the conversion of the current
  2688.                archive to be aborted).  Note that this message is only used
  2689.                when you have activity logging turned on.
  2690.  
  2691.           Aborted: VIRUS! INFECTED!
  2692.                This message occurs when the configured virus scanner
  2693.                returns a non-zero exit code after scanning files contained
  2694.                in an archive.  Note that this message is only used when you
  2695.                have activity logging turned on.
  2696.  
  2697.           ShapeShifter - User's Guide                                    47
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.           <ext>: Already defined for archiver (<archiver name>).  Replace?
  2706.                This message is displayed by SSCFG when you save archiver
  2707.                information containing an extension already defined for
  2708.                another archiver.  ShapeShifter only supports one archiver
  2709.                per extension, so it isn't possible to have the same
  2710.                extension listed for use with two different archivers
  2711.                (although you may use different archivers for the create and
  2712.                extract commands since you specify the command line to be
  2713.                used!  Typically this is done for programs such as PKZIP
  2714.                that use separate programs to create and extract files).
  2715.  
  2716.           Archiver name must be specified.
  2717.                This message is displayed by SSCFG when you attempt to save
  2718.                information about an archiver with the archiver name listed
  2719.                as blank.  The archiver name is a mandatory field - if you
  2720.                don't want to save the archiver information abort by
  2721.                pressing ESCape instead of using the F10 key.
  2722.  
  2723.           AttrAbort
  2724.                This message is displayed in the work history window for a
  2725.                file that is not converted since it contains attributes, and
  2726.                the archive type you're converting to isn't configured as
  2727.                supporting attributes.  (Use the strip attributes option to
  2728.                overcome this).
  2729.  
  2730.           -AV File
  2731.                This message is displayed next to a file in the work history
  2732.                window to indicate the file wasn't converted because it
  2733.                contained the PKZIP -AV marking (and you have ShapeShifter
  2734.                configured to leave AV files alone).
  2735.  
  2736.           Both the redo & protect options are set - ignoring the redo
  2737.           option
  2738.                This message is displayed when you specify ShapeShifter
  2739.                should redo existing archives AND keep the old files. 
  2740.                (Since redoing a file implies it will be changed, it is not
  2741.                possible to redo the file and keep the old one too.  This
  2742.                message just lets you know that ShapeShifter is protecting
  2743.                the original files and ignoring the request to redo files
  2744.                that are already in the target format).
  2745.  
  2746.           Complete
  2747.                This message is displayed in the work history window (and
  2748.                log file) indicating a file was successfully converted.
  2749.  
  2750.           Configuration not initialized.  Run SSCFG.
  2751.                Before you use ShapeShifter for the first time you *must*
  2752.                run the configuration program.  Run SSCFG and save the
  2753.                configuration to overcome this message.
  2754.  
  2755.           48                                        ShapeShifter Appendices
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.           Corrupt
  2764.                This message is displayed in the work history window (and
  2765.                log file) indicating an archive was corrupt.  ShapeShifter
  2766.                considers the archive corrupt when the archiver used to
  2767.                extract the files returns a non-zero exit code.
  2768.  
  2769.           CreateErr
  2770.                This message is displayed in the work history window.  It
  2771.                occurs when any of the following happen:
  2772.  
  2773.                     Archiver returns a non-zero exit code when ShapeShifter
  2774.                     asks it to create the new archive.
  2775.  
  2776.                     The target file already exists.  (I.E. you're
  2777.                     converting TEST.ZIP to LZH and TEST.LZH already
  2778.                     exists).
  2779.  
  2780.                     The new archive file can't be found after the
  2781.                     conversion is complete.
  2782.  
  2783.           Create command appears to be missing the archive file name
  2784.           specifier.
  2785.                This message is displayed by SSCFG when you save the
  2786.                information about an archiver if the create command doesn't
  2787.                contain one of the substitution fields to specify the
  2788.                filename.  Since an archiver generally requires the name of
  2789.                the file that should be created you probably should add the
  2790.                proper substitution field so ShapeShifter can tell the
  2791.                archiver which file is being worked on.  (It is suggested
  2792.                you use the %1 field, but other fields are also available).
  2793.  
  2794.           DirAbort
  2795.                This message is displayed in the work history window when an
  2796.                archive conversion is aborted because the archive contains
  2797.                dirs (and the archive type you're converting to doesn't
  2798.                support them OR ShapeShifter is configured to not allow
  2799.                conversion of archives containing subdirs).
  2800.  
  2801.           Error:  Invalid option (X)
  2802.                This message occurs when you specify an invalid command line
  2803.                option (the X is replaced by the letter of the invalid
  2804.                option).
  2805.  
  2806.           EXEC Err
  2807.                This message is displayed in the work history window when an
  2808.                error keeps one of the configured commands from being
  2809.                executed (archiver, virus scanner, and user commands are
  2810.                included).  In general this error means the command you
  2811.                specified either doesn't exist in your path, or there isn't
  2812.  
  2813.           ShapeShifter - User's Guide                                    49
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.                enough memory to run the command.  Memory problems for the
  2822.                archivers can be overcome by using the Switch! option.  If
  2823.                you're having memory problems for other commands - please
  2824.                let me know - if there is a need I can add use of Switch!
  2825.                for all commands.
  2826.  
  2827.           EXEC Failure
  2828.                This message means the same as EXEC Err (listed above),
  2829.                except this message is what appears in the activity log.
  2830.  
  2831.           Extension is blank.  Save record anyway?
  2832.                This message is displayed by SSCFG when you ask to save
  2833.                information about an archiver with a blank extension. 
  2834.                Although this isn't really an error, it's brought to your
  2835.                attention because most archivers use a non-blank extension
  2836.                for archives created.
  2837.  
  2838.           Extract command appears to be missing the archive file name
  2839.           specifier.
  2840.                This message is displayed by SSCFG when you save the
  2841.                information about an archiver if the extract command doesn't
  2842.                contain one of the substitution fields to specify the
  2843.                filename.  Since an archiver generally requires the name of
  2844.                the file that should be extracted you should add the proper
  2845.                substitution field so ShapeShifter can tell the archiver
  2846.                which file is being worked on.  (It is suggested you use the
  2847.                %1 field, but other fields are also available).
  2848.  
  2849.           File length too large.
  2850.                This error message is displayed by SSCFG when the file
  2851.                length (for the user defined BBS dir) is too large.  The
  2852.                maximum value ShapeShifter allows is 70.
  2853.  
  2854.           <file>: Has a size bigger than the size field!  <file size>
  2855.                This error occurs when ShapeShifter is asked to update a dir
  2856.                file that contains a file size field that is defined as
  2857.                being smaller than the minimum required for the file.  (For
  2858.                example, the dir type has a file size of 6 associated with
  2859.                it, and the actual file size is over 999,999 bytes).
  2860.  
  2861.           INFECTED!
  2862.                This is the message that is displayed in the work history
  2863.                window when the virus scanner indicates one or more files
  2864.                inside an archive are infected with a virus.
  2865.  
  2866.           Invalid date stamping method:
  2867.                An invalid date stamping method was specified on the command
  2868.                line.
  2869.  
  2870.  
  2871.           50                                        ShapeShifter Appendices
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.           No file(s) specified/found to convert.
  2880.                This occurs when you don't specify filespecs to convert, or
  2881.                if there aren't any files of a configured archive type that
  2882.                match the filespecs you specify.
  2883.  
  2884.           No matching dir files!
  2885.                This occurs when you have the option set to update a BBS dir
  2886.                file, but no DIR files are found matching the filespecs you
  2887.                configured.
  2888.  
  2889.           Pre command returned error:  <9>  Continue conversion?
  2890.                This message is displayed when the external pre command (the
  2891.                one that is ran before any conversions are done) returns a
  2892.                non-zero exit code.
  2893.  
  2894.           <file>: Read error.
  2895.                There was an error encountered when ShapeShifter tried to
  2896.                read the specified file.
  2897.  
  2898.           RedoAbort
  2899.                This message is displayed in the work history window when
  2900.                ShapeShifter is unable to create a unique extension for a
  2901.                file already in the target format that is being redone. 
  2902.                ShapeShifter tries 1000 different extensions before giving
  2903.                up.
  2904.  
  2905.           Scan Only
  2906.                This message is displayed in the work history window when a
  2907.                file is not converted because it was being scanned only
  2908.                (i.e. an internal archive when you have ShapeShifter set not
  2909.                to convert them).
  2910.  
  2911.           SFX Offset must be between 255 and -255
  2912.                This message is displayed by SSCFG when the value you
  2913.                specify for the file offset of the SFX Id String is outside
  2914.                the range of 255 to -255.
  2915.  
  2916.           Size length too large.
  2917.                This message is displayed by SSCFG when the length of the
  2918.                size field (for the user defined BBS type) exceeds the
  2919.                maximum ShapeShifter allows.  The maximum supported is 20
  2920.                characters.
  2921.  
  2922.           Size Skip
  2923.                This message is displayed in the work history window when a
  2924.                file is skipped because the new file would be larger than
  2925.                the original file was.
  2926.  
  2927.           Skipped
  2928.  
  2929.           ShapeShifter - User's Guide                                    51
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.                This message is displayed in the work history window when a
  2938.                file is skipped because it's already in the target format
  2939.                and the redo option is turned off.
  2940.  
  2941.           Skipped: (Already in target format)
  2942.                This message is the same as above except it's the one
  2943.                displayed in the activity log.
  2944.  
  2945.           Skipped: -AV File
  2946.                This message is displayed in the activity log when a file is
  2947.                skipped because it contains PKZIPs AV signature (and you
  2948.                have ShapeShifter configured to leave AV files alone).
  2949.  
  2950.           Skipped: Only scanning internal arc
  2951.                This message is displayed in the activity log when an
  2952.                internal archive is skipped because you have ShapeShifter
  2953.                configured to not convert internal archives, but it was
  2954.                scanned for virii.
  2955.  
  2956.           Skipped: Original file is smaller
  2957.                This message is displayed in the activity log when a file is
  2958.                skipped because it the new file would be larger than the
  2959.                original was.
  2960.  
  2961.           SysError:
  2962.                This message is displayed in the work history window when an
  2963.                internal ShapeShifter or operating system error occurs.
  2964.  
  2965.           Target archiver create command is blank:
  2966.                This message is displayed when you ask ShapeShifter to
  2967.                convert to an extension that doesn't have a create command
  2968.                specified.
  2969.  
  2970.           Unable to create a temp directory.
  2971.                This error means ShapeShifter was unable to create it's temp
  2972.                work directory for conversion of a file.  (ShapeShifter
  2973.                creates a working directory as a child dir of the path
  2974.                containing the original file to be converted).  If you get
  2975.                this error message your file is either in the root directory
  2976.                of a disk with a completely full root, or is likely on a
  2977.                disk that you don't have write capabilities to (i.e. a
  2978.                network security problem).
  2979.  
  2980.           <file>: Unable to open.
  2981.                This error message occurs when SSCFG can't open the
  2982.                configuration file for reading.
  2983.  
  2984.           Unable to open file for converted files list
  2985.  
  2986.  
  2987.           52                                        ShapeShifter Appendices
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.                This message is displayed when ShapeShifter is unable to
  2996.                open the file you specified for saving the list of converted
  2997.                files in.
  2998.  
  2999.           Unable to open log file
  3000.                This message is displayed when ShapeShifter is unable to
  3001.                open the file you specified for activity logging in.
  3002.  
  3003.           Unable to read configuration file.
  3004.                This message means that ShapeShifter can't locate the
  3005.                configuration file (or the file is corrupt).
  3006.  
  3007.           Unable to rename to <file>
  3008.                This message is displayed when the attempt to rename the
  3009.                temp file created while an archive of the target type is
  3010.                redone fails.
  3011.  
  3012.           UserAbort
  3013.                This message is displayed in the work history window when
  3014.                conversion of an archive is aborted because one of the user
  3015.                defined commands returned a non-zero exit code.
  3016.  
  3017.           <file>: Version x.x required to read.
  3018.                This message is displayed if your configuration file was
  3019.                created with a later version of ShapeShifter than you're
  3020.                currently using (and the format was changed).  You should
  3021.                use the same version of ShapeShifter (or a later one) than
  3022.                you use to create the configuration file.
  3023.  
  3024.           You must define some archivers before saving!
  3025.                This message is displayed by SSCFG if you attempt to save
  3026.                the configuration file while no archivers are defined.
  3027.  
  3028.           You must specify what to convert file(s) to.  Use /EXT=xxx
  3029.                This message is displayed when you run ShapeShifter with an
  3030.                invalid extension specified as the target.  (ShapeShifter
  3031.                requires the target extension to be configured as an
  3032.                archive).
  3033.  
  3034.           You probably need to specify *.* in the create command.  
  3035.                This message is displayed by SSCFG when you ask to save the
  3036.                current archiver information and the create command doesn't
  3037.                contain *.* in it.  For most archivers you need to specify
  3038.                the files to add to the newly created archive (which means
  3039.                you should have *.* in your command line).
  3040.  
  3041.           <file>: Write error.
  3042.                This message is displayed by SSCFG when an error occurs
  3043.                writing the configuration file.
  3044.  
  3045.           ShapeShifter - User's Guide                                    53
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.           Appendix D - Specifying Command Lines
  3054.  
  3055.           Several of ShapeShifter's options are intended to contain a
  3056.           command line.  In ShapeShifter the text you type as the command
  3057.           line is handled to look as if you typed it at the DOS prompt -
  3058.           with an important exception.  Before passing the command line to
  3059.           DOS, ShapeShifter first examines the command line to determine
  3060.           the location of fields such as the current filename.
  3061.  
  3062.           To allow you to specify where things like the filename should go,
  3063.           ShapeShifter supports a type of field substitution.  The
  3064.           following table lists fields that ShapeShifter supports.  When
  3065.           ShapeShifter encounters the text in a command line option it will
  3066.           perform the substitution listed in the table.  (Note that it
  3067.           doesn't matter if there are spaces before or after the field in
  3068.           the command line.  In addition, case is not sensitive.  You may
  3069.           specify the fields using upper or lower case):
  3070.  
  3071.                Field     Value that is substituted
  3072.                -----     -------------------------
  3073.                %1        The full path of the file (includes the filename
  3074.                          and extension).
  3075.  
  3076.                %D        Drive letter of the file currently being
  3077.                          converted.
  3078.  
  3079.                %E        The extension of the file that's being converted.
  3080.  
  3081.                %F        Filename that's being converted (without the
  3082.                          extension).
  3083.  
  3084.                %N        The filename and extension that's being converted.
  3085.  
  3086.                %P        Directory of the file being converted.
  3087.  
  3088.                %%        Sends a single percent sign.  This allows you to
  3089.                          override the substitution that ShapeShifter
  3090.                          normally performs when a field listed above is
  3091.                          required in the command line.  For instance, if
  3092.                          your command line contains %%D, ShapeShifter will
  3093.                          send %D to the command line instead of
  3094.                          substituting the drive for %D.
  3095.  
  3096.  
  3097.           Notes:    The extension that's substituted (for any field that
  3098.                     contains an extension) depends on where in the
  3099.                     conversion process you are.  The extension you're
  3100.                     converting to is substituted in the following commands:
  3101.  
  3102.  
  3103.           54                                        ShapeShifter Appendices
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.                          Archive create command
  3112.  
  3113.                          Command to execute after extracting an archive
  3114.  
  3115.                          Command to execute after creating an archive
  3116.  
  3117.                     For the extract command as well as the command to
  3118.                     execute before extracting an archive, the original file
  3119.                     extension is substituted.
  3120.  
  3121.           Commands that don't appear on the archiver options screen in
  3122.           SSCFG don't have valid values for the fields listed above (i.e.
  3123.           this includes the scanner command, command to execute before
  3124.           beginning the conversion, and the command to execute after all
  3125.           conversions are done).  If any of the fields are specified in
  3126.           these command lines, they will be removed.
  3127.  
  3128.  
  3129.           Example Command Lines
  3130.  
  3131.           The following examples assume that you're converting a file
  3132.           called IC186.ZIP to IC186.LZH.  For the examples, the directory
  3133.           IC186.ZIP is in is:  D:\CATALOG.
  3134.  
  3135.           Command Line        Field This Command Line Is In
  3136.           ------------        -----------------------------
  3137.           mycmd %f %e         Command to execute before extracting the
  3138.                               archive.
  3139.  
  3140.                Resulting command line that's executed: mycmd IC186 ZIP
  3141.           ----------------------------------------------
  3142.           mycmd %f %e         Command to execute after extracting the
  3143.                               archive.
  3144.  
  3145.                Resulting command line that's executed: mycmd IC186 LZH
  3146.           ----------------------------------------------
  3147.           pkunzip %1          Archive extract command
  3148.  
  3149.                Resulting command line that's executed: 
  3150.  
  3151.                     pkunzip D:\CATALOG\IC186.ZIP
  3152.           ----------------------------------------------
  3153.           lha a %1 *.*        Archive create command
  3154.  
  3155.                Resulting command line that's executed:
  3156.  
  3157.                     lha a D:\CATALOG\IC186.LZH *.*
  3158.           ----------------------------------------------
  3159.  
  3160.  
  3161.           ShapeShifter - User's Guide                                    55
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.           mycmd %1 %%1        Command to execute after archive is created
  3170.  
  3171.                Resulting command line that's executed:
  3172.  
  3173.                     mycmd D:\CATALOG\IC186.LZH %1
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.           56                                        ShapeShifter Appendices
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.           Appendix E - Answers to Commonly Asked Questions
  3228.  
  3229.  
  3230.           Q:   Are there any dangers to having ShapeShifter update my BBS
  3231.                directory file?
  3232.  
  3233.           A:   All ShapeShifter does when it updates a BBS file is changes
  3234.                the extension to the new one, and also modifies the size
  3235.                information to be correct for the new file.
  3236.  
  3237.                You need to insure that any external programs that need ran
  3238.                to create index files, etc are done by you.  
  3239.  
  3240.                Auntie users should note that modification of the DIR file
  3241.                to change the file extension causes the number of times the
  3242.                file was downloaded to be lost (the original file name
  3243.                contained in the history file has the old extension).
  3244.  
  3245.  
  3246.           Q:   All I want to do is scan the file contents for virus and
  3247.                then move them.  Is there a way I can do this without
  3248.                converting them?
  3249.  
  3250.           A:   ShapeShifter allows you to effectively do this by using the
  3251.                test mode option.  If you desire to move the files after the
  3252.                test is complete, simply specify an external command to be
  3253.                executed after the test.
  3254.  
  3255.  
  3256.           Q:   How do I include redirection in the command lines? 
  3257.                Redirection appears to be ignored by ShapeShifter.
  3258.  
  3259.           A:   Redirection can be accomplished using three different
  3260.                methods.  To cause ShapeShifter to support redirection in
  3261.                your command lines you should either:
  3262.  
  3263.                     1)   Turn on the use of Switch! for the command.
  3264.  
  3265.                     2)   Start the command with:  'command /c '.  For
  3266.                          example to call PKZIP to create an archive you
  3267.                          would use 'command /c pkzip -a -ex FILE *.*'
  3268.                          instead of 'pkzip -a -ex FILE *.*'.
  3269.  
  3270.                     3)   Use a batch file to call the external command
  3271.                          (which would force you to also do one of the two
  3272.                          options above).
  3273.  
  3274.  
  3275.  
  3276.  
  3277.           ShapeShifter - User's Guide                                    57
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.                                                                       Index
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.  
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.           
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.           activity logging                   create command
  3344.                setting level  28                  option  20
  3345.           age of files                       date stamping
  3346.                specifying  29                     option  21
  3347.           answers  57                        dir 
  3348.           archive to convert to                   size start,len
  3349.                specifying  19                          option  36
  3350.           archiver                           dir file
  3351.                create command  20                 file start,len
  3352.                extract command  24                     options  25, 26
  3353.                support dir option                 option  22
  3354.                     37                            r. just option  30
  3355.           archiver name                           update option  39
  3356.                option  13                    dir type
  3357.           archives                                option  22
  3358.                detecting corrupt             dirs
  3359.                     43                            archiver support  37
  3360.                recursing  31                 EMS
  3361.                redoing  33                        Switch!ing to  38
  3362.           attributes                         equipment
  3363.                stripping  37                      required  6
  3364.           author verification                error messages  47
  3365.                option  14                         work history window 
  3366.           author verified files                        43
  3367.                preserving  30                extension
  3368.           AV files                                converting to  19
  3369.                preserving  30                     option  23
  3370.           bad files directory                extract command
  3371.                option  15                         option  24
  3372.           bbs                                features  7
  3373.                support  6                    field substitution
  3374.           BBS DIR                                 in command lines  54
  3375.                specifying type  22           file attributes
  3376.                update option  39                  archiver option  24
  3377.           check for sfx                      file start,len
  3378.                option  15                         option  25, 26
  3379.           command lines                      i/o redirection  32
  3380.                specifying  54                keep original archive
  3381.           convert archives with                   option  26, 27
  3382.                     subdirs                  license  4
  3383.                option  19                    log filename
  3384.           convert to                              option  27
  3385.                option  19                    logging level
  3386.           converted files                         option  28
  3387.                create list of  20            max age of files to
  3388.           converted list filename                      convert
  3389.                option  33                         option  29
  3390.           corrupt archives                   memory
  3391.                detecting  43                      making available  29
  3392.  
  3393.           
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.           memory to make available                scanner command  34
  3402.                option  29                         scanner supports
  3403.           options                                      dirs  35
  3404.                archiver name  13                  size start,len  36
  3405.                author verification                specifying  12
  3406.                     14                            strip attributes  37
  3407.                bad files directory                subdirs (archiver
  3408.                     15                                 support)  37
  3409.                check for sfx  15                  Switch! to ems  38
  3410.                command line  11                   Switch! to xms  38
  3411.                command to execute                 test only  39
  3412.                     before                        update bbs dir  39
  3413.                     conversion  17                use 43/50 line mode 
  3414.                convert archives                        40
  3415.                     with subdirs                  use Switch!  40
  3416.                     19                            use virus scanner 
  3417.                convert to  19                          41
  3418.                converted list                parameter
  3419.                     filename  33                  types  10
  3420.                create command  20            preserve author verified
  3421.                create list of                          files
  3422.                     converted files               option  30
  3423.                     20                       protecting
  3424.                date stamping  21                  original file  26,
  3425.                dir file  22                            27
  3426.                dir type  22                  purchasing  9
  3427.                extension (of                 Q&A  57
  3428.                     archiver)  23            questions
  3429.                extract command  24                common  57
  3430.                file attributes  24           r. just
  3431.                file start,len  25,                option  30
  3432.                     26                       recurse archives
  3433.                keep original                      option  31
  3434.                     archive  26, 27          recurse subdirs
  3435.                log filename  27                   option  31
  3436.                logging level  28             redirect i/o
  3437.                max age of files  29               option  32
  3438.                memory to make                redo archives
  3439.                     available  29                 option  33
  3440.                overview  10                  registering  9
  3441.                preserve author               required equipment  6
  3442.                     verified files           scan all files
  3443.                     30                            option  34
  3444.                r. just  30                   scanner command
  3445.                recurse archives  31               option  34
  3446.                recurse subdirs  31           scanner supports dirs
  3447.                redirect i/o  32                   option  35
  3448.                redo archives  33             self extracting
  3449.                scan all files  34                 checking for  15
  3450.  
  3451.           60
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.           self extractors
  3460.                detecting  36
  3461.           sfx files
  3462.                detecting  15, 36
  3463.           sfx id string
  3464.                option  36
  3465.           size start,len
  3466.                dir option  36
  3467.           specifying
  3468.                age of files   29
  3469.                archive to convert
  3470.                     to  19
  3471.                BBS dir filename  22
  3472.                BBS dir type  22
  3473.                command lines  54
  3474.                date stamp method 
  3475.                     21
  3476.           Starting ShapeShifter  10
  3477.           strip attributes
  3478.                option  37
  3479.           subdirs
  3480.                recursing   31
  3481.                support option  19
  3482.           subdirs (archiver
  3483.                     support)
  3484.                option  37
  3485.           support
  3486.                getting  6
  3487.           Switch! to EMS
  3488.                option  38
  3489.           Switch! to xms
  3490.                option  38
  3491.           test only
  3492.                option  39
  3493.           update bbs dir
  3494.                option  39
  3495.           use 43/50 lines
  3496.                option  40
  3497.           use Switch!
  3498.                option  40
  3499.           use virus scanner
  3500.                option  41
  3501.           virus scanner
  3502.                command  34
  3503.                using  41
  3504.           warranty  5
  3505.           XMS
  3506.                Switch!ing to  38
  3507.  
  3508.  
  3509.           ShapeShifter - User's Guide                                    61
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.           62
  3568.